home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 17 / AMIGAplus Sonderheft 17 (1999)(ICP)(DE)[!].iso / PD / Anwendungen / -DataTypes- / animation / animation4106.readme < prev    next >
Text File  |  1998-06-17  |  9KB  |  219 lines
  1. Short:    Animation.datatype V41.6
  2. Author:   GISBURN@w-specht.rhein-ruhr.de (Roland Mainz)
  3. Uploader: GISBURN@w-specht.rhein-ruhr.de (Roland Mainz)
  4. Type:     util/dtype
  5. Replaces: util/dtype/animation4105.lha
  6.  
  7. ----
  8.  
  9. New since V41.5:
  10.     V41.6
  11.       - Fixed the bug that STM_LOCATE did not work properly. The
  12.         DTA_TriggerMethods info says that "Locate" is
  13.         (STM_LOCATE | STMD_ULONG), but the trigger command dispatcher
  14.         checked the old STM_LOCATE (without the STMD_#? flag).
  15.         Now the trigger command dispatcher masks the trigger method
  16.         using ((trigger_method) & ~STMF_DATA_MASK) to get rid of the
  17.         STMD_#? info...
  18.         Fixed.
  19.  
  20.       - Added SHARECHIP / NOSHARECHIP options. Before V41.6, the
  21.         animation.datatype tests incoming planar bitmaps of they lie in
  22.         chipmem can can be passed to BltBitMapRastport directly without
  23.         using a copy to a chipmem buffer.
  24.         Now this test is avoided unless the SHARECHIP option is on
  25.         again. The prefs docs about this option explains why this may be
  26.         good in certain cases...
  27.  
  28.       - tapedeck.gadget's special GM_RENDER mode 100 (GREDRAW_SLIDER, e.g.
  29.         only update embedded slider) is never more treated as an hack.
  30.  
  31.       - Small speedup because tapedeck's rastport using for
  32.         GM_RENDER/GREDRAW_SLIDER is now set up at GM_LAYOUT time
  33.         instead of a once-pre-draw setup.
  34.  
  35.       - The 8-bit-chunkypixel remapping code has been re-written.
  36.         It now remaps RPL8 / remap / WPL8 instead using a RPA8 / remap /
  37.         WPA8 cycle (the line-by-line should be more cache-friendly and
  38.         therefore faster...).
  39.         The memory needed for this remapping is also reduced
  40.         significantly...
  41.  
  42.       - The 8-bit-chunkypixel remapping code never more checks
  43.         for the return codes of RPL8/RPA8 nor WPL8/WPA8.
  44.         It seems that the GFX-Card driver software sometimes returns
  45.         rubbish here...
  46.         Should fix some reported blank displays...
  47.  
  48.       - Added support for FIF_ABILITIES (bit 31, (0x80000000UL)).
  49.         This flag indicates that animation.datatype supports the
  50.         FIF_#? flags. "GMultiView" for example now looks on this
  51.         flag and is able to show a HAM/EHB animation on a public
  52.         screen if we support the remapping for it.
  53.  
  54.       - Fixed the bug that DTM_TRIGGER did not send
  55.         DTERROR_COULDNT_SEND_MESSAGE in the case of no receiver.
  56.         Fixed.
  57.  
  58.       - Now SAS/C's build-in math functions are used instead of
  59.         the C macros...
  60.  
  61.       - Changed the default value of ADTA_NumPrefetchFrames.
  62.         Instead of 10 frames to prefetch now (1/2 fps) number of
  63.         frames will be pre-fetched during loading.
  64.         Setting ADTA_NumPrefetchFrames explicitly by OM_SET or
  65.         by the prefs-file will turn this automatic selection off
  66.         again...
  67.         This may give a more reasonable default value for
  68.         mpegvideo.datatype's NOLOADALL mode...
  69.  
  70.       - Fixed the bug in OM_NEW that if realtime.libary/CreatePlayerA
  71.         failed with an PLAYER_ErrorCode error not of RTE_NOMEMORY or
  72.         RTE_NOCONDUCTOR Result2 (IoErr) was set to 0.
  73.         Due lack of a good dos.library error code if've set the
  74.         code to 1234L for now.
  75.         Fixed.
  76.  
  77.       - Small modifications in the code which may caused problems with
  78.         animations with more than 16384 pixel width and/or height.
  79.         These dimensions are currently therorectical, but:
  80.         Fixed.
  81.  
  82.       - DTM_REMOVEOBJECT now causes that all queuing frames in the
  83.         display queue are disposed (e.g. moved to the dispose queue).
  84.         This avoids the bug that removing the object from a window
  85.         and re-attaching it again may cause that next play cycle will
  86.         display these frames first.
  87.         Fixed.
  88.  
  89.       - The priority of the display and load processes are now set up
  90.         based on the parent process priority (e.g. the process which
  91.         executes OM_NEW).
  92.         The display process gets parent process priority, the load
  93.         process gets "parent priority - 1".
  94.         This allows to run the playback at higher priorities.
  95.  
  96.       - { GA_Immediate, TRUE } is not set any more for the
  97.         tapedeck.gadget. This seems to fix some problems with input
  98.         processing from tapedeck.gadgets.
  99.  
  100.       - Fixed the bug that tapedeck.gadget's TDECK_CurrentFrame attribute
  101.         wasn't updated if DTA_ControlPanel is set to TRUE.
  102.         Fixed.
  103.  
  104.       - ADTM_START now clears the load queue explicitly if the first
  105.         frame in the queue matches not the given "asa_Frame".
  106.  
  107.  
  108. ----
  109.  
  110. INTRODUCTION
  111.     animation.datatype is the datatypes base class for all animation
  112.     and movie subclasses. It is responsible for remapping, sound,
  113.     scronisation, creating the controls and misc. other things
  114.  
  115. FEATURES
  116.     - Supports now the full animation.datatype interface like defined
  117.       in include31:datatypes/animationclass.h:
  118.       - Supports palette-per-frame, e.g. each frame can have it's own
  119.         palette.
  120.  
  121.       - Dynamic timing. A frame can have a variable duration until
  122.         the next frame occurs.
  123.  
  124.     - Fully compatible to the original animation.datatype V40.7
  125.  
  126.     - Configurable througth a preferences file.
  127.  
  128.     - Includes a CPU blitter for planar screens. If enabled by the prefs
  129.       file, animation.datatype uses a CPU blitter instead of the OS
  130.       blitter.
  131.  
  132.     - CyberGFX compatible:
  133.       - Now animation.datatype V41 can handle non-planar bitmaps, e.g.
  134.         chunkypixel bitmaps, as input.
  135.         (Currently they cannot be remapped, the bitmaps are displayed
  136.         unchanged on the destination screen).
  137.  
  138.       - Supports HAM/EHB -> 24-bit remapping. (TEMPORARY DISABLED).
  139.  
  140.     - No skipping anymore. The aniation.datatype V41 introduces
  141.       a new feature called "adaptive frame rate selection". Instead
  142.       of skipping frames when they cannot be displayed in real-time,
  143.       the FPS rate is now adapted to fit (e.g. the maximum available
  144.       playback speed without skipping).
  145.  
  146.  
  147. REQUIREMENTS
  148.     - You need at least Kick/WB 3.0.
  149.  
  150.     - "realtime.library", >= V39              - for timing
  151.     - "gadgets/tapedeck.gadget" (any version) - for the controls
  152.  
  153.        You need "sound.datatype" >= V40 for sound support.
  154.  
  155. USAGE
  156.     Usage is very simply: If you  have loaded an animation, you can
  157.     control the animation using the tapedeck gadget at the bottom:
  158.     "<<" skips some frames back
  159.     ">"  starts playing
  160.     ">>" skips some frames forward.
  161.     The slider part can be used to move manually to a specific
  162.     postion in the animation/movie.
  163.  
  164.     Note that there is also a prefs-file where you can set various
  165.     options. See "preferences" section for details.
  166.  
  167. INSTALLATION
  168.     After unpacking this archive:
  169.     Because this version does not include an Installer script, you have
  170.     to do the installation manually through the shell:
  171.  
  172.       - Unpack this archive and copy the "animation.datatype" to
  173.         SYS:Classes/DataTypes/:
  174.  
  175.         Copy CLONE FROM "animation.datatype" TO
  176.         "SYS:Classes/DataTypes/animation.datatype"
  177.  
  178. AUTHOR
  179.     If you want to blame me, report any bugs, or wants a new version
  180.     send your letter to:
  181.                     Roland Mainz
  182.                     Hohenstaufenstraße 8
  183.                     52388 Nörvenich
  184.                     GERMANY
  185.  
  186.     Phone: (+49)(0)2426/901568
  187.     Fax:   (+49)(0)2426/901569
  188.  
  189.     EMAIL is also available (if you want to send me attachments
  190.     larger than 1MB (up to 5MB, more with my permission):
  191.  
  192.     GISBURN@w-specht.rhein-ruhr.de
  193.  
  194.     Up to August 1998 I'm reachable using this email address, too:
  195.     Reinhold.A.Mainz@KBV.DE
  196.  
  197.     | Please put your name and address in your mails !
  198.     | German mailers should add their phone numbers.
  199.     | See BUGS section above when submitting bug reports.
  200.  
  201.     Sorry, but I can only look once a week for mails.
  202.     If you don't hear something from me within three weeks, please
  203.     send your mail again (but watch about new releases) (problems with
  204.     this email port are caused by reconfigurations, hackers, network
  205.     problems etc.).
  206.  
  207.     The  entire  "animation.datatype"  package  may  be  noncommercially
  208.     redistributed, provided  that  the package  is always  distributed
  209.     in it's complete  form (including it's documentation). A small
  210.     copy fee  for media costs is okay but any kind of commercial
  211.     distribution is strictly forbidden without my permission !
  212.     Comments and suggestions how to improve this program are
  213.     generally appreciated!
  214.  
  215. ----
  216.  
  217. Bye,
  218. Roland
  219.